HMDVRDevice

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.

Nicht standardisiert: Diese Funktion ist nicht standardisiert. Wir raten davon ab, nicht-standardisierte Funktionen auf produktiven Webseiten zu verwenden, da sie nur von bestimmten Browsern unterstützt werden und sich in Zukunft ändern oder entfernt werden können. Unter Umständen kann sie jedoch eine geeignete Option sein, wenn es keine standardisierte Alternative gibt.

Die HMDVRDevice-Schnittstelle der WebVR API repräsentiert ein Head-Mounted Display und bietet Zugriff auf Informationen über jedes Auge, sowie die Möglichkeit, das aktuelle Sichtfeld zu ändern.

Instanzmethoden

HMDVRDevice.getEyeParameters() Veraltet Nicht standardisiert

Gibt die aktuellen Parameter für das angegebene Auge ("links" oder "rechts") zurück, wie z. B. Sichtfeldinformationen, die in einem VREyeParameters-Objekt gespeichert sind.

HMDVRDevice.setFieldOfView() Veraltet Nicht standardisiert

Legt das Sichtfeld für beide Augen fest.

Instanzeigenschaften

Diese Schnittstelle definiert keine eigenen Eigenschaften, erbt jedoch die Eigenschaften ihrer übergeordneten Schnittstelle, VRDisplay.

VRDisplay.hardwareUnitId Schreibgeschützt

Gibt die eindeutige Hardware-ID für die gesamte Hardware-Einheit zurück, deren Teil dieses VRDevice ist. Alle Geräte, die Teil desselben physischen Geräts sind, haben dieselbe hardwareUnitId.

VRDisplay.displayId Schreibgeschützt

Gibt die ID für dieses spezifische VRDevice zurück. Die ID sollte sich bei Neustarts des Browsers nicht ändern, was die Speicherung von Konfigurationsdaten ermöglicht, die darauf basieren.

VRDisplay.displayName Schreibgeschützt

Ein lesbarer Name zur Identifikation des VRDevice.

Beispiele

Das folgende Beispiel, das aus der WebVR-Spezifikation entnommen wurde, findet das erste verfügbare HMDVRDevice und das damit verbundene PositionSensorVRDevice, falls vorhanden.

js
navigator.getVRDevices().then((devices) => {
  for (const device of devices) {
    if (device instanceof HMDVRDevice) {
      gHMD = device;
      break;
    }
  }

  if (gHMD) {
    for (const device of devices) {
      if (
        device instanceof PositionSensorVRDevice &&
        device.hardwareUnitId === gHMD.hardwareUnitId
      ) {
        gPositionSensor = devices[i];
        break;
      }
    }
  }
});

Browser-Kompatibilität

Siehe auch